DlgPaste

Copy TextEdit scrap over selected editText item

#include <Dialogs.h> Dialog Manager

void DlgPaste(theDialog );

DialogPtr theDialog ; identifies dialog window

DlgPaste deletes the currently-selected text in the current editText item of

a dialog and inserts the text from the TextEdit scrap in its place. It is a quick

way to process a paste command (V) event for a dialog.

theDialog is the address of a DialogRecord; It identifies the dialog containing

the item to which the paste operation should be applied.

Notes: If the current dialog contains no editText items, or if none is active, this

function does nothing. Otherwise, it performs a TEPaste on the

currently-selected text.

The item number-1 of the active editText field is kept in the editField field

of the DialogRecord and a handle to its TERec is kept in the textH field.

Thus, this call is functionally equivalent to:

DialogPeek theDlgPeek;

theDlgPeek = (DialogPeek) theDialog;

if ( theDlgPeek -> editField > 0 ) {

TEPaste( theDlgPeek->textH );

}

In a modal dialog, DlgCut, DlgCopy, DlgPaste, and DlgDelete are

typically performed in a filter function (see ModalDialog). In a modeless

dialog, you should check for X, C, P, and B by examining the event

record after calling IsDialogEvent and when present, use the DlgXxx calls

You do not need to support cut-and-paste in editText items, but since it is

easy to do, it is recommended.

Referenced by (12):